package xx.services.page.inter;

import javax.ws.rs.FormParam;
import javax.ws.rs.PathParam;

/**
 * page页面TabItem管理服务接口
 * 
 * @Path (Constants.RESTFUL_ROOT_PATH + "/page/tab/item")
 * @author chenxiang 2010-12-19
 * 
 */
public interface ITabItemInterface
{
    /**
     * 获取一个TabItem，包含ItemContent<br>
     * 
     * @GET
     * @Path ("/{item_id}")
     * @param itemId-@PathParam("item_id")
     *            TabItemID
     * @return TabItem实体，包含ItemContent
     * @author chenxiang
     */
    public String get(@PathParam("item_id")
    long itemId);

    /**
     * 获取一个TabItem html代码，包含ItemContent的内容<br>
     * 
     * @GET
     * @Path ("/{item_id}/html")
     * @param itemId-@PathParam("item_id")
     *            TabItem ID
     * @return TabItem Html代码，不是json数据
     * @author chenxiang
     */
    public String getHtml(@PathParam("item_id")
    long itemId);

    /**
     * 修改一个TabItem demo。<br>
     * 
     * @PUT
     * @Path ("/{item_id}")
     * @param itemId-@PathParam("item_id")
     *            TabItem ID
     * @param item-@FormParam("item")
     *            TabItem demo的Json字符串
     * @return 新的TabItem 实体
     * @author chenxiang
     */
    public String update(@PathParam("item_id")
    long itemId, @FormParam("item")
    String item);
    
    /**
     * 获取指定列id的所有内容
     * 
     * @GET
     * @Path ("/{item_id}/content")
     * @param itemId
     *          itemId 布局列ID
     * @return
     * @author dengjinye 2011-9-18
     */
    public String getContent(long itemId);
}
